"""
Modal 基础示例 - Hello World
功能：演示最基本的 Modal 应用结构，包括 App 定义、函数装饰器和本地入口点
运行：modal run 01_hello_world.py
"""
import modal

# 1. 定义一个 App，作为组织代码的命名空间
app = modal.App("hello-world-app")

# 2. 使用 @app.function() 装饰器将普通 Python 函数转变为云函数
@app.function()
def square(x):
    print("这段代码正在云端运行！")
    return x * x

# 3. 使用 @app.local_entrypoint() 定义一个本地入口，用于从命令行调用
@app.local_entrypoint()
def main():
    # 使用 .remote() 调用云函数
    print("42 的平方是:", square.remote(42))
